FMA skeletal spine — bones as the clamped convergence anchor (Located-primary GUID)#116
Merged
Merged
Conversation
Operator directive (2026-06-23): "FMA is a must... bones not being negotiable... hardcoded hand-optimized convergence optimization" + "project ViT or X-ray and especially ultrasound × Doppler". The two requirements are one constraint: bones must be hardcoded and stable BECAUSE they are the cross-modal registration frame every modality projects onto. New crate `ogar-fma-skeleton`: - morton.rs: the 2bit×2bit 4×4 Morton-tile pyramid. Uniform 16×8-bit (16-byte) family-node key — never a 12+4 carve (the operator correction: a heterogeneous carve breaks the uniform Morton stride and loses the perturbation-shader data). Each nibble = one 4×4 tile (X/Y interleaved); 32 levels; tier = level>>2. assign_morton_suffixes descends the sibling quadtree so prefix = spatial = partonomy. - lib.rs: hand-curated atlas (~80 nodes: full vertebral column C1–coccyx, skull, sternum, 12 rib pairs, major appendicular bones per side). Each bone's 16-byte address is DERIVED from its rest-pose centroid, so parent.is_ancestor_of(child) holds AND laterality lives in the X-tile. Bones are clamped Dirichlet anchors by definition (no un-clamped bone). 16 tests: tree integrity, prefix=partonomy=spatial containment, unique node keys, clamped-anchor invariant, unit-quaternion frames, laterality, address stability. ogar-vocab: new ConceptDomain::Anatomy (0x0A) — anatomical_structure / skeleton / bone / joint (0x0A01..04). Anatomy is public reference, not PHI, so it gets its own domain (not Health 0x09, which would drag it into medcare's fail-closed RBAC set). The ~206 bones are cascade-path nodes under the `bone` concept, not codebook slots (FMA = the Wikidata-HHTL pattern: the hierarchy lives in the path). docs/FMA-SKELETON-CONVERGENCE-ANCHOR.md + DISCOVERY-MAP D-FMA-SKELETON. Address structure CODED (16 tests); splat-fit convergence CONJECTURE, gated on the splat-native arc (SPLAT-NATIVE-CUSTOMER.md §6 litmus). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EYvNjD8M8LMNYbRy3gq2FP
…ade, 12+4
Operator design download (2026-06-23, with the papillary-muscle worked
example + the located/cascade "heel" distinction):
- guid.rs: the brutal uniform GUID as a stack of [256:256] tiers, each the
same scale-free relation [container:member] (Galaxy:planet, country:city,
bodypart:bone, cm²:mm², residue:atom). Tier{container,member}, Guid with
per-tier accessors, classid/heel/leaf, same_family ("identity attached to
family node" = tiers..LEAF equal, identity varies).
- HhtlMode::{Located, Cascade} — the "heel" duality. Located (Cesium):
HEEL is the literal position, HHTL = spatial_tier Morton, location-
preserving — the BONE case (bones ARE the anchor). Cascade (ontology):
HEEL is a classification rung (Anatomy…PapMuscle), no spatial address,
HHTL = ontology_tier — the MUSCLE case (classified, then projected onto).
Both share the LEAF familyNode:identity and the 16-byte key.
- EdgeBlock: the 12+4 edge block (12 in-family local relations + 4
out-of-family inherited connector interfaces), one byte per slot — the
papillary-muscle family-node template.
- LeafTile{family_node, identity} = the [bodypart:bone] leaf.
Additive — the working bone atlas (FamilyAddress) is untouched. 22 tests
green (16 + 6 new), clippy-clean. Doc §5b records the tier model + the
located/cascade duality + the splat-projects-onto-the-class framing.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EYvNjD8M8LMNYbRy3gq2FP
Operator correction (2026-06-23): the 12-in-family + 4-out-of-family edge block is the OLD taxonomy, before family nodes. Removed EdgeBlock entirely. With the [container:member] family-node tiers, relations ARE the addressing: - local relation ⇔ shared family prefix (Guid::same_family) - cross relation ⇔ a reference to another node's Guid (unbounded) No fixed edge carve; the node stays a pure key+value block. Test `relations_are_family_prefix_not_an_edge_block` replaces the edge-block test; doc §5b updated. Also recorded: located + cascade HHTL modes may both be used on one key (operator's call). 22 tests green, clippy-clean. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EYvNjD8M8LMNYbRy3gq2FP
Each bone now resolves to a 16-byte Guid (the [256:256] container:member
tier model), Located-primary since bones ARE the position anchor:
classid = 0x0A03 (Anatomy:bone)
HEEL/HIP = the rest-pose 3-axis CRS — HEEL coronal x:y, HIP depth z
(located_heel_hip) — ArcGIS/Cesium-addressable, so the body is
a GIS layer and ViT / ultrasound×Doppler project onto the same
coordinate
LEAF = familyNode:identity = [bodypart:bone] — the parent group is the
family (identity 0 IS the group's family node; identity >=1 are
its bones)
same_family now keys on classid + leaf family_node (mode-agnostic): in
Located mode the spatial HHTL is the orthogonal location axis, so two
same-family bones sit at different positions. is_ancestor walks parent
links (partonomy), not an address prefix.
Tests rewritten for the Guid model (24 pass): classid tier, HEEL laterality
(left/right femur differ in HEEL, same family, different identity), HIP
depth (sternum anterior vs vertebra posterior), unique node keys + leaves,
family-node grouping with attached identity, parent-link ancestry, clamped
anchors, unit quaternions, classid stability. clippy-clean.
Morton primitives + FamilyAddress stay in morton.rs as the value-side
splat-refinement tool. Crate docs updated to the Guid model.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EYvNjD8M8LMNYbRy3gq2FP
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
The whole-workspace `cargo check + test` caught what per-crate testing missed: ogar-class-view's OgarClassView registry has a drift gate requiring every codebook concept to be registered, and the anatomy mints (anatomical_structure / skeleton / bone / joint, 0x0A01..04) were absent. Added them to all_canonical_classes() in codebook order (after health, before auth) + the imports. Workspace test now fully green: - every_codebook_id_appears_in_class_ids_all ... ok - known_class_ids_iterates_in_stable_codebook_order ... ok - registry_carries_every_codebook_concept ... ok Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EYvNjD8M8LMNYbRy3gq2FP
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this is
A new
ogar-fma-skeletoncrate: the hand-curated FMA skeleton as theclamped convergence anchor for the splat-native ultrasound arc
(
docs/SPLAT-NATIVE-CUSTOMER.md§6 litmus). Operator-directed across thesession; the address model converged through several corrections recorded
below.
The constraint (one, not two): bones must be hardcoded and stable
because they are the cross-modal registration frame that ViT, X-ray, and
ultrasound × Doppler all project onto. Bones are the only rigid bodies in the
human, so the skeleton is not data being fit — it is the boundary
condition of the fit. Clamping the splat-fit to a hand-curated skeleton
makes the convergence well-posed and deterministic (the Class IIa SaMD
requirement).
The address — the
[256:256][container:member]GUIDEach bone resolves to a 16-byte
Guid: a uniform stack of[256:256]tiers,each the same scale-free relation
[container : member](Galaxy:planet,country:city,bodypart:bone,cm²:mm²,residue:atom). Bones areLocated-primary (they ARE the position anchor):
off-the-shelf spatial ops work and ViT / ultrasound × Doppler project onto
the same coordinate. Two HHTL modes are supported (
HhtlMode):Located (Cesium, position-preserving — the bone case) and Cascade
(ontology, the self-speaking path — the soft-tissue case).
identity == 0is the family node,identity ≥ 1are its bones ("identity attached to family node").carrying the perturbation pyramid's
(exponent, location)(OGAR owns those;ndarray owns
phase, magnitude).Consumes
D-MORTON(DISCOVERY-MAP §2.1); recorded asD-FMA-SKELETON.Codebook
New
ConceptDomain::Anatomy(0x0A) inogar-vocab:anatomical_structure/
skeleton/bone/joint(0x0A01..04), in lockstep across CODEBOOK +class_idsconsts +ALL+ builders. Anatomy is public reference, notPHI — kept out of Health
0x09so it is not dragged into medcare'sfail-closed Health RBAC set (preserves its
Health == 7invariant). The ~206bones are cascade-path nodes under the
boneconcept, not codebook slots.Relations
No
12+4edge block — that is the pre-family-node taxonomy and was removed.With family nodes, relations ARE the addressing: local = shared family
prefix (
same_family), cross = a reference to another node'sGuid.Atlas coverage & honesty
~80 nodes: full vertebral column C1–coccyx, skull, sternum, 12 rib pairs,
major appendicular bones per side — structured to extend to the full ~206
without schema change. Rest poses are a proportional T-pose v0 (to be
refined against a real FMA-aligned mesh); FMA ids are cross-referenced only
where confidently known (the address identity is a stable atlas id, never a
fabricated FMA id). HIP is coronal-tile + depth-slice (not yet a single 3D
octree — its odd bits are reserved). The address structure is CODED;
the splat-fit convergence claim is CONJECTURE, gated on the splat-native
arc.
Tests / gates
cargo test -p ogar-fma-skeleton— 24 + 2 doctests green: Morton math,classid tier, HEEL laterality, HIP depth, unique node keys + leaves,
family-node grouping with attached identity, parent-link partonomy, the
clamped-anchor invariant, unit-quaternion frames, classid stability.
ogar-vocab94 tests green (drift gates updated for the anatomy mints).The new crate is
cargo clippy-clean; the 12 pre-existingogar-vocabclippy warnings are untouched (zero added).
Docs
docs/FMA-SKELETON-CONVERGENCE-ANCHOR.md(the unity, the GUID tier model,located/cascade, the projection operators) +
D-FMA-SKELETONin theDISCOVERY-MAP.
🤖 Generated with Claude Code
Generated by Claude Code